*Configuration*

KillStats is highly flexible in regards to formatting.  As the server admin, you have a lot of control over what the users see.  Let's start with the CVARS.

*Enable/Disable*

These cvars let you decide which items you'd like users to see.  If you only want to show damage done / damage taken in chat but still show everything in the menus, you could easily accomplish this by setting sm_killstats_chat_show_killed=0 and sm_killstats_chat_show_killed_by=0.  So there are 8 different config options for this, 4 to determine which menus should be shown and 4 to determine which chat options should be shown.  They are:

sm_killstats_menu_show_killed
sm_killstats_menu_show_killed_by
sm_killstats_menu_show_damage_done
sm_killstats_menu_show_damage_taken

sm_killstats_chat_show_killed
sm_killstats_chat_show_killed_by
sm_killstats_chat_show_damage_done
sm_killstats_chat_show_damage_taken

*Display Order*
This is a more advanced way of setting up what will be shown.  The cvars are:

sm_killstats_chat_display_order
sm_killstats_menu_display_order

These can be set using the following values in the order desired:

1=Kills
2=Killed By
3=Damage Done
4=Damage Taken

So, to show them in "normal" order for menus, set sm_killstats_menu_display_order="1234" (this is actually the default).  If you wanted show Killed By, then Damage Taken, then Damage Done in chat, set sm_killstats_chat_display_order="243".  Note that using the display order option means you won't need to use the enable/disable cvars - it will only show the ones you choose.  The default for chat is to show just killed by and damage done, so you'll need to set it to something like "1234" if you want to see everything again.

*Format*

Here's where you can really customize this plugin.  One note on this - I WOULD NOT RECOMMEND CHANGING THE #format LINES.  If you want to remove something from the output, just remove it from the language lines.  For example, change "{1} - {2} ft" to "{1}" if you just want to show the name, the distance param will still be passed in, but ignored.

Let's start with...


*#1 - Kills*

	// Information to show in section 1 - Kills
	// 1 = Player Name (that I killed)
	// 2 = Distance of kill
	"menu_killed_details"
	{
		"#format"	"{1:s},{2:.2f}"
		"en"		"{1} - {2} ft"
	}

	"chat_killed_details"
	{
		"#format"	"{1:s},{2:.2f}"
		"en"		"You killed {1} ({2} ft)"
	}

So, the default would be something like "Deception5 - 12.32 ft" in the menus and "You killed Deception5 (15.32 ft)" in chat.  You could change this or remove the distance if you wanted by modifying the "en" line (or the appropriate language).


*#2 - Killed By* is a little more advanced (but not much).  The default for menus is something like "Deception5 - 32.4 ft - (32 health remaining)" and for chat "Deception5 still had 32 health after killing you (32.4 ft)".  Changing the "en" string to something like "{1}({3} health) @ {2} ft" can really make it look customized - "Deception5(23 health) @ 22 ft".  Don't forget that chat messages have no headers though, so if you put this message in chat, make sure it mentions that it is a "killed by" message or it will confuse the player.

	// Information to show in section 2 - Killed By
	// 1 = Player Name (that killed me)
	// 2 = Distance of kill
	// 3 = Health remaining of killer
	"menu_killed_by_details"
	{
		"#format"	"{1:s},{2:.2f},{3:d}"
		"en"		"{1} - {2} ft - ({3} health remaining)"
	}

	"chat_killed_by_details"
	{
		"#format"	"{1:s},{2:.2f},{3:d}"
		"en"		"{1} still had {3} health after killing you ({2} ft)"
	}



*#3 - Damage Done*
These are broken into 2 categories.  Death and Damage.  This allows you to specify some different things based on whether the victim was actually killed or only hurt.  For example, in chat you could change chat_damage_done_death_string to say " You killed {1}..." instead of using the "*Hit {1}" (where the * represents a kill).  The chat ones are specific to damage done where the menu ones will look the same for damage done and damage taken (but it will be apparent because they will be below a different menu item).


	// Information to show in section 3/4 - Damage Done/Received
	// Don't change the format string, just remove the ones that you don't want from the translation string
	// 1 = Name of the person I hit
	// 2 = Amount of damage I did
	// 3 = Number of hits against the person
	// 4 = Headshot string 
	// 5 = Distance 
	"menu_death_string"
	{
		"#format"	"{1:s},{2:d},{3:d},{4:s},{5:.2f}"
		"en"		"*{1} - {2} damage - {3} hits {4} - {5} ft"
		"de"		"*{1} - {2} Schaden - {3} Treffer {4} - {5} ft"
	}

	"chat_damage_done_death_string"
	{
		"#format"	"{1:s},{2:d},{3:d},{4:s},{5:.2f}"
		"en"		"*Hit {1} for {2} damage in {3} hits {4} - {5} ft"
		"de"		"*{1} - {2} Schaden - {3} Treffer {4} - {5} ft"
	}

	// Subset of the death string (no distance)
	// 1 = Name of the person I hit
	// 2 = Amount of damage I did
	// 3 = Number of hits against the person
	// 4 = Headshot string 
	"menu_damage_string"
	{
		"#format"	"{1:s},{2:d},{3:d},{4:s}"
		"en"		" {1} - {2} damage - {3} hits {4}"
		"de"		" {1} - {2} Schaden - {3} Treffer {4}"
	}

	"chat_damage_done_string"
	{
		"#format"	"{1:s},{2:d},{3:d},{4:s}"
		"en"		" Hit {1} for {2} damage in {3} hits {4}"
		"de"		" {1} - {2} Schaden - {3} Treffer {4}"
	}


*#4 - Damage Taken*

These are the same as #3, but are the damage/death strings for damage taken.  Be sure to take into account the fact that they don't have a header so they should show something like "Hit by" or "Killed by".

	// Information to show in section 3/4 - Damage Done/Received
	// For chat, these must be differentiated because we don't show section headers, so you won't
	// know the difference between being the victim and the attacker if the strings are the same
	// Don't change the format string, just remove the ones that you don't want from the translation string
	// 1 = Name of the person I hit
	// 2 = Amount of damage I did
	// 3 = Number of hits against the person
	// 4 = Headshot string 
	// 5 = Distance 

	"chat_damage_taken_death_string"
	{
		"#format"	"{1:s},{2:d},{3:d},{4:s},{5:.2f}"
		"en"		"*Hit by {1} for {2} damage in {3} hits {4} - {5} ft"
		"de"		"*{1} - {2} Schaden - {3} Treffer {4} - {5} ft"
	}

	// Subset of the death string (no distance)
	// 1 = Name of the person I hit
	// 2 = Amount of damage I did
	// 3 = Number of hits against the person
	// 4 = Headshot string 
	"chat_damage_taken_string"
	{
		"#format"	"{1:s},{2:d},{3:d},{4:s}"
		"en"		" Hit by {1} for {2} damage in {3} hits {4}"
		"de"		" {1} - {2} Schaden - {3} Treffer {4}"
	}


*Headshot(s)*
The headshot strings (chat_headshot_string/menu_headshot_string) will determine how to show the headshot parameter in the damage/death strings.  This is where you could take out the parens or reword the headshot phrase.  The default is "(1 headshot)" or "(X headshots)".


	// To be used in the damage string to represent head shots (singular/plural and ignored if there weren't any)
	// 1 = Number of headshots
	// 2 = The word "headshot" or "headshots" in the appropriate language
	"menu_headshot_string"
	{
		"#format"	"{1:d},{2:s}"
		"en"		"({1} {2})"
	}


	"chat_headshot_string"
	{
		"#format"	"{1:d},{2:s}"
		"en"		"({1} {2})"
	}